home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / serien / purity / nr.20 / revmaker / revmaker.dok < prev    next >
Text File  |  1995-04-22  |  12KB  |  317 lines
  1.  
  2.  
  3.        ######   ####### ##    ## ##   ##   ###   ##   ## ####### ######
  4.        ##   ##  ##      ##    ## ### ###  ## ##  ##  ##  ##      ##   ##
  5.        ##   ##  ####     ##  ##  ## # ##  ## ##  #####   ####    ##   ##
  6.        ######   ####     ##  ##  ##   ## ####### ##  ##  ####    ######
  7.        ##   ##  ##        ####   ##   ## ##   ## ##   ## ##      ##   ##
  8.        ##    ## #######    ##    ##   ## ##   ## ##   ## ####### ##    ##
  9.  
  10.  
  11.                VERSION 1.100 (EINGESCHR. VERSION)
  12.               ____________________________________
  13.  
  14.                  COPYRIGHT BY
  15.  
  16.                 BJOERN SCHOTTE
  17.                   AM BURKARDSTUHL 45
  18.                   97267  HIMMELSTADT
  19.  
  20.                    KONTOVERBINDUNG:
  21.  
  22.                    190 400 960
  23.  
  24.                   BLZ  79051580
  25.  
  26.                  Sparkasse Main-Spessart
  27.  
  28. _______________________________________________________________________________
  29.  
  30. ===============================================================================
  31. SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWA
  32. ===============================================================================
  33.  
  34. DIESE VERSION IST SHAREWARE. DIE VOLLVERSION IST FÜR DM 15.- PLUS PORTO (WOHN-
  35. SITZ MUß INNERHALB DEUTSCHLANDS SEIN !!) BEI OBEN GENANNTER ADRESSE ERHÄLTLICH.
  36.  
  37. ===============================================================================
  38. SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWARE - SHAREWA
  39. ===============================================================================
  40.  
  41. ======================================= INHALT ================================
  42.  
  43.  1. Was ist RevMaker ?
  44.  2. Warum RevMaker ?
  45.  3. Wie werde ich RevMaker-USER
  46.  4. Getting started - Programmstart
  47.  5. Grüße, Danksagungen, etc...
  48.  6. Soon coming features...
  49.  7. Beispiel-Header
  50.  8. Fehlermeldungen
  51.  9. Über den Autor
  52. 10. Sonstiges
  53. _______________________________________________________________________________
  54.  
  55. 1. Was ist RevMaker ?
  56. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  57.   RevMaker ist ein Hilfsprogramm für Pascal-Programmierer,
  58.   denn RevMaker erzeugt vollautomatisch erstellte Revision-
  59.   header zu Deinem Programm (nur das Programm mußt Du
  60.   selbst schreiben !). Zusätzlich existiert noch eine
  61.   Backup-Funktion, bei der automatisch vor dem Erstellen
  62.   eine Kopie der Datei mit dem Namen Dateiname+".old" er-
  63.   stellt wird. Diese BackUp-Funktion kann je nach Belieben
  64.   ein- und ausgeschaltet werden.
  65.  
  66.  
  67. 2. Warum RevMaker ?
  68. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  69.   Vorlage für dieses Programm war AutoRev, welches ich auf
  70.   irgendeiner Fish-Disk fand. Das Problem war, daß dieses
  71.   Programm OS2.X verlangte. Da ich nun [NOCH] kein OS2.X
  72.   habe, versuchte ich, mir dieses und ein anderes Programm
  73.   (aus der Kickstart; in Assembler programmiert) zum Vor-
  74.   bild zu nehmen und dieses Programm zu schaffen. Ich wich
  75.   davon ab, als erstes einen großen Speicherblock in der
  76.   Größe der Datei zu besorgen, da ich nicht wußte, wie man
  77.   dann den Versionsstring finden soll. Also erstellte ich
  78.   eine doppelt verkettete Liste.
  79.   Meine Ansprüche an das Programm:
  80.  
  81.     - Komfortable Oberfläche im OS2.X-Stil
  82.     - Menü-Steuerung
  83.     - Iconify-Funktion
  84.  
  85.   Tja, ich glaube, mir ist dies gelungen.
  86.  
  87.   (Anmerkung: Getestet wurde RevMaker auf einem A500 mit 1MB
  88.   Speicher, 1 Disk-Drive. Es wurden keine nennenswerten Fehl-
  89.   funktionen festgestellt. Wer aber doch irgendwelche Fehler
  90.   findet, schnell zu mir schicken, damit ich ebenfalls schnell
  91.   ein Update rausbringen kann !!!)
  92.  
  93.   ICH HAFTE NICHT FÜR IRGENDWELCHE SCHÄDEN, DIE DURCH REVMAKER HER-
  94.   VORGERUFEN WURDEN !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  95.  
  96.  
  97. 3. Wie werde ich RevMaker-User
  98. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  99.   Nun, dies ist mein erstes SHAREWARE-PROGRAMM, und ich
  100.   hoffe, daß viele RevMaker-User die Sharegebühr be-
  101.   zahlen. Sie beträgt übrigens 15 DM. Dafür bekommst Du
  102.   die Vollversion und wirst bei den zukünftigen Updates
  103.   benachrichtigt und kannst diese gegen einen kleinen
  104.   Betrag von mir erwerben.
  105.   Tja, Vollversion, richtig gelesen. Dies ist nämlich
  106.   eine eingeschränkte Version, bei der folgende Funk-
  107.   tionen gesperrt bzw. mit einem Nerv-Fenster belegt
  108.   sind:
  109.  
  110.       Programm-Start    (NERV-FENSTER)
  111.       Datei auswählen    (NERV-FENSTER)
  112.       Programm-Ende    (NERV-FENSTER)
  113.       Iconify        (GESPERRT)
  114.  
  115.   Ich habe mich dazu entschlossen, weil die Zahlungsmoral
  116.   hier in Deutschland nicht so gut ist wie z.B. in Amerika.
  117.  
  118.   Also, wenn Dir das Programm gefällt und Du es benutzt,
  119.   dann wird die SHAREWARE-Gebühr fällig. Bist Du noch nicht
  120.   bei mir registriert, so schickst Du mir 15 DM oder eine
  121.   Überweisung (auf mein Konto). Natürlich
  122.   schickst Du mir noch den ausgefüllten Bogen mit (File
  123.   "Registrierung" !!).
  124.   Wenn ich deinen Bogen und das Geld erhalten habe, be-
  125.   kommst Du sofort die Vollversion von mir geschickt und
  126.   wirst als User registriert.
  127.   Sollte dann einmal eine neue Version fertiggestellt sein,
  128.   so schicke ich Dir eine Nachricht, daß eine neue Version
  129.   fertig ist. Willst Du diese Version haben, so kannst Du
  130.   sie bei mir für einen kleinen Betrag erwerben
  131.   (Upgradegebühr plus ein, zwei Mark für den Autor [mich]).
  132.   Folgt keine Antwort von Dir, so wird die
  133.   Upgrade-Benachrichtigung aus Kostengründen eingestellt.
  134.   Du bleibst aber nach wie vor registriert.
  135.  
  136.   (Anmerkung: Siehe File "Registrierung" für genaue Er-
  137.    klärung !!)
  138.  
  139.  
  140. 4. Getting started - Programmstart
  141. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  142.   Nach dem Programmstart von der Workbench/CLI (Vollversion:
  143.   Bei Workbench-Start könnt Ihr optional noch ein zweites
  144.   Icon mit anklicken (SHIFT-Klick auf zweites Icon-Doppel-
  145.   klick auf Programm-Icon), der Dateiname wird dann in das
  146.   Eingabefeld übernommen) öffnet sich das Hauptfenster und
  147.   dann ein Fenster, das anzeigt, daß Ihr die SHAREVERSION des
  148.   Programms benutzt (ca. 30 Sek. Wartezeit). Danach müßt nur
  149.   in dieses Fenster klicken und es verschwindet. Ihr seht
  150.   dann die Oberfläche vor euch. Das erste Gadget trägt die
  151.   Aufschrift "Datei..." und kann auch mit der Taste "D" aus-
  152.   gewählt werden. Nach der Auswahl dieser Funktion öffnet
  153.   sich der ARP-Filerequester und Ihr könnt eine Datei aus-
  154.   wählen. Bei Abbruch des Filerequesters bleibt natürlich der
  155.   alte Dateiname im Stringgadget erhalten !! Somit wären wir
  156.   auch beim zweiten Gadget: Das Dateinamen-Stringgadget. Hier
  157.   könnt Ihr auch ohne Filerequester den Dateiname eintragen.
  158.   Die nächsten Stringgadgets sind:
  159.  
  160.     - Kommentar (Taste "K"): Hier ist ein bis zu 255 Zeichen
  161.       langer Kommentar einzugeben. Sollte der Kommentar
  162.       länger als 30 Zeichen sein, so wird automatisch ge-
  163.       trennt. Bei der ersten Generierung eines Revision-
  164.       headers werden die Felder Kommentar und Version NICHT
  165.       berücksichtigt (Kommentar ist dann:
  166.        "- Initial release -"; Version: "V0.000" )
  167.  
  168.     - Autor: Hier kommt der Name des Autors rein.
  169.          (max. 30 Zeichen)
  170.  
  171.     - Copyright: Hier könnt Ihr Copyright-Vermerke eintragen.
  172.          (max. 26 Zeichen)
  173.  
  174.     - Version: Ein bis zu sechs Zeichen langer String, der die
  175.       Version angibt (z.B. "ALPHA" oder "v1.234",...).
  176.  
  177.     - Purpose: Die eigentliche Funktion des Programms, das
  178.       diesen Header verpasst bekommt (wird beim Updaten NICHT be-
  179.       rücksichtigt !). (max. 80 Zeichen)
  180.  
  181.   Dann haben wir ein Cycle-Gadget, über das man die Backup-
  182.   Funktion einstellen kann. Bei aktiviertem BackUp wird
  183.   zuerst eine Kopie der Datei mit dem Namen: Dateiname+".old"
  184.   erstellt.
  185.   Der nächste Schalter ist "START". Klickt Ihr diesen Schalter
  186.   an, wird, sofern BackUp aktiviert ist, ein BackUp-File er-
  187.   zeugt, dann die Datei in den Speicher gelesen und dann,
  188.   je nachdem, ob schon ein Revision-Header existiert, ein
  189.   neuer Header angelegt oder ge-updated. Der Header kann
  190.   dabei an jeder beliebigen Stelle im Quelltext stehen
  191.   (muß aber in SPALTE 1 stehen!) !!
  192.   Neben diesem Gadget ist noch ein weiteres mit dem Namen "Save Prefs".
  193.   Es speichert den Autor und den Copyrighter in die Datei ":s/RevMaker.cfg"
  194.   und es wird versucht, diese Config-Datei bei jedem RevMaker-Start zu
  195.   laden. Konnte man diese nicht laden, werden die "Default-Einstellungen"
  196.   benutzt (eigentlich Schwachsinn, aber was soll`s !). Dieses Gadget kann
  197.   auch über die Taste <R> angewählt werden...
  198.   Das STATUS-Feld (ganz unten) informiert euch, was gerade
  199.   passiert. Sollte während dem Einlesen der Datei plötzlich
  200.   das Fenster geschlossen und das Programm beendet werden,
  201.   so ist das kein Programmfehler, nein, das liegt daran, daß
  202.   kein Speicher zur Verfügung steht, um die Datei in den
  203.   Speicher zu lesen. Beendet also noch laufende Programme bzw.
  204.   macht irgendwie den Speicher frei und startet das Programm
  205.   nochmal. Dann müßte es laufen.
  206.  
  207. 5. Grüße, Danksagungen etc...
  208. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  209.   Grüße gehen an:
  210.  
  211.     Robert Martignoni und Diesel (für die sagenhaften P.U.R.I.T.Y.s,
  212.     macht weiter so !!),
  213.     Røgersøft alias Michael Klein (Danke für die tollen Border-Rou-
  214.     tinen und Drucky und, natürlich, Røgerdat !!!)
  215.  
  216.   Und an alle, die ich vergessen hab` !!!
  217.  
  218. 6. Soon coming features...
  219. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  220.   Tja, was wäre noch wünschenswert ?
  221.  
  222.     - ONLINE-Hilfe,
  223.     - ...
  224.  
  225. 7. Beispiel-Header
  226. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  227.  
  228. Hier ein Beispiel-Header, das Datum wird jeweils immer auto-
  229. matisch eingefügt (nicht täuschen lassen, daß alle Daten auf
  230. den 19.09. zeigen, ich habe diesen Header auf einmal an einem
  231. Tag erstellt ! Normalerweise sind dann hier mehrere Daten vorhanden !).
  232.  
  233. { ****** Auto-Revision (do NOT edit) ********************
  234.   *
  235.   * © Copyright by BOMBERSOFT
  236.   *
  237.   * Filename          : RAM DISK:Beispiel
  238.   * Created on          : 19.09.1993
  239.   * Created by          : Björn Schotte
  240.   * Current revision  : V1.100
  241.   *
  242.   *
  243.   * Purpose: Beispiel-Header
  244.   *
  245.   *
  246.   * V1.100 : 19.09.1993 : Es ist nicht leicht, ein
  247.   *              perfektes Programm zu
  248.   *              schreiben, aber einer muß es
  249.   *              ja mal machen !!
  250.   *
  251.   * V1.070 : 19.09.1993 : Jetzt sogar mit
  252.   *              Pseudo-OS2.0-Oberfläche !!
  253.   *
  254.   * V1.050 : 19.09.1993 : Ich dachte, ich gönne dem
  255.   *              User mal eine Trennfunktion,
  256.   *              damit er auch mal längere
  257.   *              Kommentare eingeben kann...
  258.   *
  259.   * V0.000 : 19.09.1993 : - Initial release -
  260.   ******************************************************* }
  261.  
  262.  
  263. 8. Fehlermeldungen
  264. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  265.   Folgende Fehlermeldungen sind während des Betriebs von RevMaker
  266.   möglich:
  267.  
  268.     SCHREIB/LESEFEHLER NR. ####: Dieser Fehler tritt aus, wenn
  269.     beim Createn oder Updaten des Headers und anschliessendem
  270.     Schreiben der Datei ein Fehler auftritt. Übergeben wird die
  271.     Fehlernummer (Diese kann man in verschiedenen Büchern finden
  272.     oder aber mit meinem Programm "Huh" von der P.U.R.I.T.Y. 8
  273.     finden !).
  274.  
  275.     Der Fehler mit dem Schliessen des Fensters habe ich bereits
  276.     erklärt.
  277.  
  278. 9. Über den Autor
  279. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  280.   Tja, damit auch alle mal wissen, wer ich bin, hier eine kleine
  281.   Vorstellung:
  282.  
  283.     Name: Björn Schotte
  284.     Geburtstag: 30.09.1978
  285.     Aussehen: Vollschlank, Brillenträger, Linkshänder
  286.     Hobbys: - Compi,
  287.         - Lesen,
  288.         - Musik hören (meistens Techno, aber auch sonst alles
  289.           außer Volksmusik !)
  290.         - Radfahren (nich so oft)
  291.         - Schwimmen (auch nicht so oft)
  292.         - nochmal Compi
  293.  
  294.     Computer-Equipment:
  295.  
  296.       Amiga 500, 1MB Speicher, 1 Disk-Drive,
  297.       Drucker: Fujitsu DL1100 (saugeiles Ding, sag` ich euch !),
  298.       Monitor: 1084S (würgh..)
  299.  
  300.       und bald (so in 1-2 Wochen:)
  301.  
  302.       Amiga 4000 mit 86EC030-Prozessor und 4MB RAM, 1 Disklaufwerk.
  303.       (OS3.0).
  304.       Dann werden auch alle meine anderen Programme getestet und,
  305.       wenn ich mit der GadTools.library in Einklang gekommen bin,
  306.       auch RevMaker mit einer GadTools-Oberfläche gestaltet wird.
  307.       (Auch das PurityMag wird warscheinlich eine solche Änderung
  308.       beinhalten, aber auch weiterhin unter OS1.x laufen !!)
  309.  
  310.  
  311. 10. Sonstiges
  312. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  313.   Also, Leute, zahlt die Sharegebühr !!
  314.  
  315.   C U in next proggy, yours, Björn !!
  316.  
  317.